home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / comm / www / rexxproxy.readme < prev    next >
Text File  |  1998-05-05  |  7KB  |  168 lines
  1. Short:    Configurable ARexx-based proxy server
  2. Author:   cmdo@gte.net (Casey Halverson)
  3. Uploader: cmdo@gte.net (Casey Halverson)
  4. Type:     comm/www
  5.  
  6. RexxProxy is an ARexx-based proxy server which you can on your Amiga
  7. computer using a TCP stack such as Miami, AmiTCP, etc.  RexxProxy uses
  8. almost the same principles which ARexxWebServer (ARWS) and several other
  9. ARexx-based http applications I have written in the past.  
  10.  
  11.  
  12. Features:
  13.  
  14. o Small - only running when in use
  15.  
  16. o Keeps access logs of document requested as well as time and date of 
  17.   proxy access
  18.  
  19. o Supports a keyword-based url deny list
  20.  
  21. o Allows alias of long address to psuedo URLs
  22.  
  23. o Faster downloading routines
  24.  
  25. o Custom footer messages only displayed on text/html documents
  26.  
  27. o Multiple accesses at one time
  28.  
  29.  
  30. How is a proxy useful on the Amiga?
  31.  
  32.  
  33.   Proxies can be useful in a number of ways.  You can use it to block websites
  34. to users, alias long URLs to one word, log web access from your computer 
  35. system, host web access for multiple computers on an ethernet network, allow
  36. anonymous viewing of websites while working on a PC, or even use it to by-pass
  37. firewalls and proxies which currently exist in your environment.  However, make
  38. sure you have permission before doing so.  I am not responsable for any misuse
  39. of RexxProxy.
  40.  
  41.  
  42. How does a proxy work?
  43.  
  44.  
  45.   A proxy is very simple.  It acts exactly like an HTTP/1.0 server, however,
  46. becides just providing local files, it allows access to the entire internet.
  47. This is done by a simple "GET http://<URL>" sent to the proxy, and an enter.
  48. The proxy then processes the request, and outputs a standard HTTP/1.0 header.  
  49.  
  50.  
  51. How does RexxProxy work?
  52.  
  53.  
  54.   RexxProxy does this, with a few extra features.  With every user access,
  55. RexxProxy appends a log file containing the time, date, and site requested.
  56. It will display the URL in the log even if the access was denied, or the page
  57. did not exist.  
  58.   A denied URL is determined by scanning the entire URL for a keyword.  If any
  59. keywords are found which are on a keyword list, the request is simply denied
  60. by a text message.  Examples of this are given in the provided banned.txt file.
  61.   Aliases are also controled by an alias list.  An alias list simply requires
  62. the true URL, a space, and the wanted alias.  Examples are given in the provided
  63. alias.txt file.  Also, the html document displayed during a deny can be edited.
  64. This document is called denied.html.
  65.   A footer is created at the bottom of each page to show that the proxy is in
  66. action.  You may change this footer by changing bottom.html file.  a RexxProxy
  67. author line is automatically placed at the bottom by the proxy software.
  68.  
  69.  
  70. How do I set up RexxProxy?
  71.  
  72.   This depends on the stacker you are using, however, here are some example
  73. setups for AmiTCP and Miami.  Some people have complained to me about these
  74. configuration strings not working ... all I can say is that they work here.
  75. For those who get lost, you want to set this up as a dos wait server.  Also,
  76. make sure you have RexxMast running!  Infact, put this in your startup if it
  77. is not already. 
  78.  
  79.  
  80. ******************************************************************************
  81.  
  82. - Miami -
  83.  
  84. Enter this into your InetD:
  85.  
  86. Service  : RexxProxy
  87. Socket   : Stream
  88. Protocol : tcp
  89. Wait     : dos
  90. User     : root
  91. Server   : -
  92. Name     : c:rx  (or wherever you have the rx program)
  93. Args     : proxy:rexxproxy.rexx (or wherever you have the rexxproxy archive)
  94.  
  95. Enter this into your services:
  96.  
  97. Name     : RexxProxy
  98. ID       : 8000 or whatever port you wish to use
  99. Protocol : TCP
  100.  
  101. - AmiTCP -
  102.  
  103. Enter this into your inetd.conf:
  104.  
  105. RexxProxy stream tcp dos bin - c:rx proxy:rexxproxy.rexx
  106.  
  107. Enter this into your services:
  108.  
  109. RexxProxy 8000/tcp RexxProxy
  110.  
  111. ******************************************************************************
  112.  
  113.  
  114. Misc. Information:
  115.  
  116.   I personally developed this software with the specific intent bypass a
  117. proxy server in which a loyal cartoon dog, which will remain nameless, now
  118. filters all urls and texts for keyword content.  In order to prevent users
  119. from by-passing the proxy entirely simply by turning it off (heh), they
  120. firewalled port 80.  I am not sure how other setups are, but most other ports
  121. are left open.  Some ports to use on firewall systems would be necessary
  122. operations on ports 23, 25, 110, 113, 8000 -- being proxy server port itself,
  123. etc.  I am not endorsing such misusage, and you should always ask before doing
  124. so.
  125.  
  126. A word on security:
  127.  
  128.   Remember that RexxProxy is not a fool-proof security system.  One can switch
  129. off the proxy settings, delete the server from the hard-drive or from the inetd
  130. entry, and other nasty things.  I am not responsable for any losses or damages
  131. which result in usage.  Such "security" features could possibly be only be
  132. suitable for small children and users who do not know much about computers.  
  133.   Also, since this software uses an external program called "httpget", there
  134. could be unseen security issues.  If so, I am not responsable for losses or 
  135. damages.
  136.  
  137. Future:
  138.  
  139.   In the future I hope to incorperate more security features such as document
  140. keyword detection, encryption, passwords, maintance utilties, user levels, etc.
  141. and also avoid the use of external programs to fetch internet data.  Currently,
  142. I feel that httpget is much faster then any ARexx routine I have done so far. 
  143.   Also, I am planning on releasing several programs in the near future which I 
  144. have done.  One is called RexxMail (A hotmail-like multiuser email service),
  145. ARexxMessageBoard, and possibly my software and hardware plans to control 
  146. lights, devices, and read information as well via the world wide web.  Check
  147. out my amiga system at http://wot.dyn.ml.org/ for a demo of such software.
  148.  
  149. Contact:
  150.  
  151. You can reach me at cmdo@gte.net, or visit my system at http://wot.dyn.ml.org/
  152. and drop me a note on the message board.
  153.  
  154.  
  155. ============================= Archive contents =============================
  156.  
  157. Original  Packed Ratio    Date     Time    Name
  158. -------- ------- ----- --------- --------  -------------
  159.      269     170 36.8% 29-Apr-98 16:11:58  aliases.txt
  160.      208     143 31.2% 24-Apr-98 15:53:52  banned.txt
  161.        0       0  0.0% 24-Apr-98 16:10:32  bottom.html
  162.      157     132 15.9% 24-Apr-98 15:47:26  denied.html
  163.       77      77  0.0% 29-Apr-98 16:16:48  rexxproxy.log
  164.     5836    2614 55.2% 29-Apr-98 19:13:20  rexxproxy.readme
  165.     1887     674 64.2% 29-Apr-98 15:15:56  rexxproxy.rexx
  166. -------- ------- ----- --------- --------
  167.     8434    3810 54.8% 30-Apr-98 17:00:34   7 files
  168.